home *** CD-ROM | disk | FTP | other *** search
/ CU Amiga Super CD-ROM 17 / CU Amiga Magazine's Super CD-ROM 17 (1997)(EMAP Images)(GB)[!][issue 1997-12].iso / CUCD / Programming / MUI / MCC_TimeText / Docs / English / TimeText_mcc.doc < prev    next >
Encoding:
Text File  |  1997-10-07  |  15.8 KB  |  504 lines
  1.  
  2.                       Table of Contents
  3.  
  4.   Copyright                   - Copyright information
  5.   Distribution                - Copying conditions
  6.   Disclaimer                  - Legal Information
  7.   Trademark                   - Trademark information
  8.   Support/Updates             - How to get updates and support
  9.   Author                      - How to reach the author
  10.  
  11.   Description                 - What is TimeText.mcc?
  12.   Requirements                - Requirements for using TimeText.mcc
  13.  
  14.   Installation                - How to install TimeText.mcc
  15.   Beta testers                - Installation information for beta testers
  16.  
  17.   Developer Info              - Information for developers
  18.  
  19.   History                     - Revision history of TimeText.mcc
  20.   Todo                        - Todo list
  21.   Known problems              - List of known problems
  22.   Acknowledgments             - Acknowledgments
  23.   Please rate                 - Please rate TimeText.mcc
  24.   Software                    - Software that uses TimeText.mcc
  25.  
  26.  
  27.  
  28. Copyright
  29. ---------
  30.  
  31. This software and its documentation are copyright 1996-1997 by Kai Hofmann. All
  32. rights reserved!
  33.  
  34. - Permission for COMMERCIAL USE is only given by an extra available commercial
  35.   license that must be validated!
  36.   Contact me directly for this license, because it will be individually handed
  37.   out per your needs!
  38.  
  39. - Permission is hereby granted, without written agreement and without license,
  40.   to USE this software and its documentation for any NON-COMMERCIAL purpose,
  41.   provided that the above copyright notice and the following paragraph appear
  42.   in all copies of this software (Non-commercial includes Giftware!).
  43.  
  44.   Please send me a full version of your product at no cost including free
  45.   updates!
  46.   Extra money is welcome (For Bank Account see author - but *ONLY* send in DM
  47.   to this Bank Account!).
  48.  
  49.  
  50.  
  51. Distribution
  52. ------------
  53.  
  54. Permission is hereby granted, without written agreement and without license
  55. or royalty fees, to copy and distribute this software and its documentation
  56. for any purpose, provided that the above copyright notice and the following
  57. paragraphs appear in all copies of this software, to:
  58.  
  59. - All who will distribute this software for free!
  60. - All free accessible INTERNET servers!
  61. - All Aminet® sites
  62. - Fred Fish for his great Amiga-Software-Library
  63. - The German SAAR AG PD-Library
  64. - Angela Schmidt's Meeting Pearls series
  65. - All others who do NOT take more than US$ 5.- for one disk that includes this
  66.   software!
  67.  
  68.  
  69.  
  70. IMPORTANT NOTE:
  71.  
  72. This package may not be included on any further Aminet CD-ROMs unless authors
  73. contributing their software to the CD-ROM, (without mentioning distribution
  74. "NoCD") are granted a copy of the CD *completely* *free* *of* *charge*.
  75.  
  76. The Meeting Pearls IV CD-ROM demonstrates that a Freebie policy is also
  77. possible with "very-low-budget" CD-ROMs (*), so Aminet should quickly
  78. re-establish the same Freebie policy it used up to Aminet CD 13.
  79.  
  80. (*) Suggested retail price for MP4 is DM 14,95/US$ 12/£ 8.95.
  81.  
  82.  
  83.  
  84. DISCLAIMER
  85. ----------
  86.  
  87. THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE
  88. LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDER AND/OR OTHER
  89. PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER
  90. EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
  91. OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS
  92. TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD THE PROGRAM
  93. PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING, REPAIR OR
  94. CORRECTION.
  95.  
  96. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING WILL
  97. ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY REDISTRIBUTE THE PROGRAM AS
  98. PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL,
  99. INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO
  100. USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING
  101. RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A FAILURE
  102. OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS), EVEN IF SUCH HOLDER OR
  103. OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
  104.  
  105. THE AUTHOR HAS NO OBLIGATION TO PROVIDE MAINTENANCE, SUPPORT, UPDATES,
  106. ENHANCEMENTS, OR MODIFICATIONS.
  107.  
  108.  
  109.  
  110. Trademark
  111. ---------
  112.  
  113. DateLib is a trademark of Kai Hofmann.
  114.  
  115. Amiga, AmigaDOS and Workbench are registered trademarks of Amiga International,
  116. Inc.
  117. Aminet is a registered trademark of Stefan Ossowskis Schatztruhe GmbH
  118. SAS/C is a registered trademark of SAS Institute Inc.
  119.  
  120. All other trademarked names used herein are used for the purposes of
  121. identification and for the benefit of the trademark holder. No infringement
  122. of trademarks is intended. Trademarks remain the property of the trademark
  123. holder.
  124.  
  125.  
  126.  
  127. Support/Updates
  128. ---------------
  129.  
  130. - Updates will be available via Aminet®
  131. - Support will be available via the authors email address and via
  132.   http://home.pages.de/~i07m/amiga/mui/TimeText.html
  133.  
  134.  
  135.  
  136. Author
  137. ------
  138.  
  139. Kai Hofmann
  140. Arberger Heerstraße 92
  141. 28307 Bremen
  142. Germany
  143.  
  144. Phone: (+49)-(0)421/480780
  145. EMail: i07m@informatik.uni-bremen.de
  146.        i07m@zfn.uni-bremen.de
  147. IRC  : PowerStat@#AmigaGer
  148. WWW  : http://home.pages.de/~i07m/
  149.  
  150. Bank account : 1203 7503
  151. Account owner: Kai Hofmann
  152. Bank code    : 290 501 01
  153. Bank name    : Sparkasse in Bremen/Germany
  154.  
  155.  
  156.  
  157. Description
  158. -----------
  159.  
  160. TimeText is a Custom Class of the Magic User Interface © by Stefan Stuntz.
  161. It's a subclass of text-class and time-class.
  162.  
  163. The idea of this class was born during developing my Gregor application.
  164.  
  165. MUI public custom class that displaying a text gadget for time strings. The
  166. display format of the time string can be freely defined.
  167.  
  168. TimeText.mcc features that are of interest for users:
  169. - Can be dragged around
  170. - Handles daylight savings time
  171. - Handles time zones
  172. - Supports 12h and 24h clocks
  173. - Supports various string formats
  174.  
  175. TimeText.mcc features of interest for developers:
  176. - Based on Time.mcc
  177. - Supports MUIM_Import and MUIM_Export
  178. - The time can be read in hour/minutes/seconds format or as seconds from
  179.   midnight on
  180. - The time range can be restricted
  181. - It's possible to notify a Date.mcc object when the next or previous day
  182.   was reached
  183. - Method to set the current time
  184. - Methods for increasing and decreasing the time
  185. - Method to compare with another time object
  186.  
  187. The display format for a TimeText object can be defined by the following
  188. (locale.library compatible) formatting codes:
  189.  
  190.   %q - hour using 24-hour style
  191.   %Q - hour using 12-hour style
  192.   %H - hour using 24-hour style with leading 0s
  193.   %I - hour using 12-hour style with leading 0s
  194.   %p - AM or PM strings
  195.   %M - the number of minutes with leading 0s
  196.   %S - number of seconds with leadings 0s
  197.   %r - same as "%I:%M:%S %p"
  198.   %R - same as "%H:%M"
  199.   %T - same as "%H:%M:%S"
  200.   %X - same as "%H:%M:%S"
  201.  
  202. You can also use the following formatting codes:
  203.  
  204.   %Th1f  - hour using 12h style with leading 0s
  205.   %Th1v  - hour using 12h style without leading 0s
  206.   %Th2f  - hour using 24h style with leading 0s
  207.   %Th2v  - hour using 24h style without leading 0s
  208.   %Tpso  - a/p
  209.   %Tpsu  - A/P
  210.   %Tplo  - am/pm
  211.   %Tplu  - AM/PM
  212.   %Tmf   - minute with leading 0s
  213.   %Tmv   - minute without leading 0s
  214.   %Tsf   - second with leading 0s
  215.   %Tsv   - second without leading 0s
  216.   %Tj.   - jd time starting with '.'
  217.   %Tj,   - jd time starting with ','
  218.   %Tj0   - jd time starting with '0.'
  219.   %Tj1   - jd time starting with '0,'
  220.  
  221.   %Tzh?? - hours only
  222.   %Tzm?  - 0100 (always with leading 0s)
  223.   %TzM?? - 01:00
  224.   %Tz?z? - Use Z   for UTC/GMT
  225.   %Tz?0? - Use +00 for UTC/GMT
  226.   %Tz??f - use leading 0s
  227.   %Tz??v - do not use leading 0s
  228.  
  229.   %Tc1   - Use DST for summer->winter change hour
  230.   %Tc2   - Use I/II for summer->winter change hour
  231.   %Tc3   - Use a/b for summer->winter change hour (24h only) - on 12h
  232.            falls back to 2
  233.  
  234.  
  235.  
  236. Requirements
  237. ------------
  238.  
  239. - MUI 3.1 (Version 12)
  240. - date.library
  241. - locale.library
  242.  
  243. - To use the Greek MCC-Install script you need the
  244.   "Greek Workbench" © AC Software
  245.  
  246. - To use the Russian MCC-Install script you need
  247.   "Rusifier" © Dmitry Mikhilov
  248.  
  249.  
  250.  
  251. Installation
  252. ------------
  253.  
  254. Only use the installer script!
  255. (The Installer must be in your system-path!)
  256.  
  257. If you use an Installer prior to V42 you should set the LANGUAGE Tooltype to
  258. your language. Installer V42 and better automatically use your current locale.
  259.  
  260.  
  261. Please note that the installer-script is very special, because:
  262.  
  263. - It features uninstallation
  264. - It is automated
  265. - It is very flexible
  266. - It is very intelligent (for an installer-script ;-)
  267. - It uses WrapGuide (if present) for the AmigaGuide®
  268.   documentation if running under a pre V39 system.
  269. - It can be reused by (hopefully) all other MUI custom classes, because the
  270.   authors of custom classes need to only change a few things:
  271.  
  272.   * The #copyright variable
  273.   * The #min_os_version and #min_os_revision variables
  274.   * The #min_mui_version and #min_mui_revision variables
  275.   * The #language_mcc and #language_mcc variables
  276.   * The P_CustomExists, P_CustomInstall and P_CustomUninstall procedures
  277.   * The 'APPNAME' tooltype within the MCC-Install icon.
  278.  
  279.  
  280.  
  281. Beta testers
  282. ------------
  283.  
  284. Version numbers of beta release will not change, so you must uninstall an
  285. earlier installed beta version before you can install a newer one!
  286.  
  287.  
  288.  
  289. Information for Developers
  290. --------------------------
  291.  
  292. There is no multiple inheritance for Boopsi/MUI for the moment, so we haven't
  293. any chance to create a real Time basis-class. But there is another way to have
  294. the same result (compatibility for all classes that are dealing with time).
  295. The solution is called interface inheritance like it was done with IDL for
  296. CORBA.
  297. TimeText.mcc inherits the interface from Time.mcc!
  298.  
  299.  
  300. Btw. it would be wise to use a
  301.  
  302.  SetAttrs(obj,
  303.             MUIA_Time_Hour, hour,
  304.             MUIA_Time_Min,  min,
  305.             MUIA_Time_Sec,  sec,
  306.           TAG_DONE
  307.          );
  308.  
  309. instead of single set()'s.
  310.  
  311.  
  312. - The following attributes are filtered out, so that they can't bring
  313.   a TimeText object into trouble:
  314.   MUIA_Text_Contents, MUIA_Text_HiChar, MUIA_Text_SetVMax, MUIA_FillArea
  315.  
  316. - When MUIA_ObjectID is defined a TimeText object will load/save the
  317.   following data during MUIM_Application_Load/MUIM_Application_Save
  318.   Hour, Min, Sec, Time Zone, DaylightSaving status
  319.  
  320.  
  321.  
  322. History
  323. -------
  324.  
  325. 14.08.1997 -    First release on Aminet
  326. 07.10.1997 -    Second release on Aminet
  327.         * Optimizations
  328.         * Simplified demo - thanks to Brett Beebe
  329.         * Now based on Time.mcc 12.4
  330.         * Compiled with MCCLib 12.4
  331.  
  332.  
  333.  
  334. Todo
  335. ----
  336.  
  337. MUIV_Font_Time
  338.  
  339.  
  340.  
  341. Known problems
  342. --------------
  343.  
  344. - I heard that using 'test' and then 'cancel' the test settings within the
  345.   MUI preference manager will not work as expected when in using your MUI
  346.   classes within Libs:MUI/ instead of MUI:Libs/MUI/ !!!
  347.  
  348. - Old versions of the program called 'PhoneCost' written by André Schenk
  349.   <schenkae@tick.informatik.uni-stuttgart.de> installed another
  350.   'date.library' into 'Libs:'.
  351.  
  352.  
  353.  
  354. Acknowledgments are going to the following people:
  355.  
  356. Rita Reichl         : for correcting my English and being my inspiration
  357.  
  358. James Cooper,
  359. Steve Krueger,
  360. Doug Walker         : For supporting SAS/C® after SAS suspends the support.
  361.  
  362. Stefan Stuntz       : for the Magic User Interface and for his support
  363. Klaus Melchior      : for the MUI custom class support
  364. Martin Huttenloher  : for MagicWB
  365. Udo Schuermann      : for WrapGuide
  366. Stefan Kost         : for ag2txt
  367. Jürgen Kohrmeyer    : for the rexxtricks.library
  368.  
  369. Eric Gerard         : for his great icons
  370. Brett Beebe         : for his hint about MUIs internal timer usage
  371.  
  372.  
  373.  
  374. Please rate
  375. -----------
  376.  
  377. Please rate TimeText.mcc and MCC-Install. To do so, send an email to
  378. aminet-server@wuarchive.wustl.edu
  379. with the following content:
  380.  
  381. RATE dev/mui/MCC-Install.lha <num>
  382. RATE dev/mui/MCC_TimeText.lha <num>
  383.  
  384. where <num> is a mark from 0..10 with 10 being the best.
  385. You can rate several programs in one mail.
  386.  
  387. Thank you!
  388.  
  389.  
  390.  
  391. Software
  392. --------
  393.  
  394. The following software products use TimeText.mcc:
  395.  
  396.  
  397.  
  398.  
  399.                       This is a custom class of the
  400.  
  401.  
  402.                         MUI - MagicUserInterface
  403.  
  404.                  Copyright © 1993-1997 by Stefan Stuntz
  405.  
  406.  
  407. MUI is a system to generate and maintain graphical user interfaces. With
  408. the  aid  of  a  preferences program, the user of an application has the
  409. ability to customize the outfit according to his personal taste.
  410.  
  411. MUI is distributed as shareware. To obtain a complete package containing
  412. lots of examples and more information about registration please look for
  413. a  file  called  "muiXXusr.lha"  (XX means the latest version number) on
  414. your local bulletin boards or on public domain disks.
  415.  
  416.           If you want to register directly, feel free to send
  417.  
  418.  
  419.                          DM 30.-  or  US$ 20.-
  420.  
  421.                                   to
  422.  
  423.                              Stefan Stuntz
  424.                         Eduard-Spranger-Straße 7
  425.                              80935 München
  426.                                 GERMANY
  427.  
  428.  
  429.              Support and online registration are available at
  430.  
  431.                           http://www.sasg.com/
  432.  
  433.  
  434.  
  435.                  This product is based on or uses parts of
  436.  
  437.                      MagicWB - The Workbench Enhancer
  438.                      --------------------------------
  439.  
  440.                  Copyright © 1992-1997, Martin Huttenloher
  441.  
  442. If  you  use  and like this product you should very much consider to take a
  443. look  at  MagicWB,  which  is the authentic source of the style, colors and
  444. design  elements  contained  in  this  package.   It  features  hundreds of
  445. original  icons,  patterns, image-drawers,  dock-brushes and some specially
  446. designed  high-quality  fonts  to  improve the comfort & legibility of your
  447. daily Workbench session.
  448.  
  449. What  is  MagicWB?   MagicWB  is  a full replacement for the Graphical User
  450. Interface  of the Workbench and has become the standard visual interface on
  451. the  Amiga.  Over the last years MagicWB has received various merits and an
  452. overwhelming  response from Amiga magazines and users worldwide proclaiming
  453. it  "a  must  for  all  Amiga  users".   Even  commercial  applications are
  454. supporting the multi-colored look & style of MagicWB.
  455.  
  456. Get yourself the latest version of MagicWB and see for yourself the wonders
  457. it  can  do by automatically transforming your old and dull Amiga Workbench
  458. into  an impressive workstation environment that will be the envy of all PC
  459. Windows  and  Mac users.  Update yourself to the state-of-the-art workbench
  460. standard  everyone uses on the Amiga!  It is also your key to enjoy the new
  461. look & feel of many applications and other MWB add-ons and extensions.
  462.  
  463. MagicWB  is  distributed as shareware.  Get yourself the latest FREE PUBLIC
  464. RELEASE of MagicWB now:  It is called
  465.  
  466.                              ----------------
  467.                               MagicWB21p.lha
  468.                              ----------------
  469.  
  470. and  can  be found everywhere on Aminet (or your local BBS or public domain
  471. series).   Install it and witness the instant magic it performs on your old
  472. Amiga  Workbench.   Also  included  is the latest SASG registration program
  473. with which you can order and get the full registered version of MagicWB.
  474.  
  475.              If you want to order directly, feel free to send
  476.  
  477.                   DM 30.- or US$ 20.- (cash, no checks!)
  478.  
  479.                                     to
  480.  
  481.                             Martin Huttenloher
  482.                              Am Hochstraess 4
  483.                                D-89081 Ulm
  484.                                  Germany
  485.  
  486. You  may  also  choose  to visit the official MagicWB homepage on the world
  487. wide  web.   There you can find the latest news & support and even register
  488. your  MagicWB  online  (which is much more comfortable and faster). You can
  489. even  benefit  from  various  special offers & discounts for MagicWB if you
  490. order through our website!  Come and visit MagicWB at:
  491.  
  492.                           ----------------------
  493.                            http://www.sasg.com/
  494.                           ----------------------
  495.  
  496.               Save 20% by using the discounts on our website!
  497.  
  498.            Ordering online also saves you a lot of time and work!
  499.  
  500.  
  501.  
  502. WrapGuide is Copyright 1994-1995 Udo Schuermann
  503. All rights reserved
  504.